home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_6 / issue_10 / riscos_3 / !Arm3Icon / !Help < prev    next >
Encoding:
Text File  |  1993-06-01  |  3.7 KB  |  115 lines
  1. !Help file for !Arm3Icon
  2.  
  3. This little utility contains a number of useful? features.
  4.  
  5. Initially designed to switch the cache on and off after upgrading to RO3
  6. the utility expanded to incorporate a few other features. 
  7.  
  8. There are four modes of operation:-
  9.  
  10. 1) Click on the icon with any mouse button to switch the cache on and
  11.    off. Please note that any changes of the cache status caused by any
  12.    other programs or by typing *cache on|off from the command line will
  13.    be reflected by the icon.
  14.  
  15. 2) Dragging a file or directory to the icon will set the current filer
  16.    directory to that directory. ie it performs a *DIR.
  17.  
  18. 3) Dragging a file or directory to the icon with the <SHIFT> key pressed
  19.    down will toggle open the CFS# version of the filer window or the
  20.    un-CFS#'ed version of the window.
  21.  
  22. 4) Holding <SHIFT>|<CTRL>|<ALT> down and clicking Adjust, Menu, or 
  23.    Select on the icon will perform one of 21 different *command strings.
  24.    These commands are held in the file "commands" and can be edited at
  25.    will. Commands may be multi-line, the deliminator between different
  26.    key combinations is the [00] (null) byte.
  27.  
  28.    Do not remove any of the [00]'s. You have been warned!!!.
  29.  
  30.    The order of the commands is as follows:-
  31.  
  32.         <SHIFT>+Adjust
  33.         <SHIFT>+Menu
  34.         <SHIFT>+Select
  35.  
  36.         <CTRL>+Adjust
  37.         <CTRL>+Menu
  38.         <CTRL>+Select
  39.  
  40.         <SHIFT>+<CTRL>+Adjust
  41.         <SHIFT>+<CTRL>+Menu
  42.         <SHIFT>+<CTRL>+Select
  43.  
  44.         <ALT>+Adjust
  45.         <ALT>+Menu
  46.         <ALT>+Select
  47.  
  48.         <ALT>+<SHIFT>+Adjust
  49.         <ALT>+<SHIFT>+Menu
  50.         <ALT>+<SHIFT>+Select
  51.  
  52.         <ALT>+<CTRL>+Adjust
  53.         <ALT>+<CTRL>+Menu
  54.         <ALT>+<CTRL>+Select
  55.  
  56.         <ALT>+<SHIFT>+<CTRL>Adjust
  57.         <ALT>+<SHIFT>+<CTRL>+Menu
  58.         <ALT>+<SHIFT>+<CTRL>+Select
  59. Notes
  60.  
  61. To start "tasks" from this utility, use the "*wimptask" command. 
  62. ie to run impression where the path to impression is:-
  63.         adfs::Harddisc4.$.Mystuff.!Impress
  64. then the correct syntax to use in the "commands" file is :-
  65.         wimptask adfs::Harddisc4.$.Mystuff.!Impress
  66.  
  67. This utility is designed to work with RISC OS 3.1. It has not been tested
  68. on any other RISC OS versions and almost certainly will not work with
  69. RISC OS 2.0 unless a cache control module is loaded up first.
  70.  
  71. In addition you will also need to have set up the CFS filing system before
  72. <SHIFT> dragging any files onto the icon.
  73.  
  74. Sprites
  75. I actually prefer the Atomwide/Aleph One sprites (ie the hare and the
  76. tortoise) to the ones I have included. If you have a copy of their
  77. sprites copy the hare as "cache_on" and the tortoise as "cache_of" into
  78. the !Sprites file of !Arm3Icon. I normally copy the hare as !arm3icon as well.
  79.  
  80. Known bug.
  81. When using this with !Alarm, there are rare occasions when the "ShutDown"
  82. sequence appears to hang. Pressing <Escape> will cure this and shutdown
  83. will proceed as normal. I must admit I haven't spent a long time 
  84. searching for this bug - if anyone has any ideas please contact me at
  85. the address below.
  86.  
  87. Future developments
  88. When I eventually get around to it I hope to add a small menu picker ie when the
  89. menu button is pressed over the icon a scrollable window will appear with all
  90. the key shortcuts shown.
  91.  
  92. Any other ideas?
  93.  
  94.  
  95. Copyright PerciPherson Software 1993
  96.  
  97. The writers give no guarantees this software is free from errors.
  98. Anyone using this software and finding bugs should contact:-
  99.  
  100. Derek Percival
  101. 33 Court Crescent
  102. Swanley
  103. Kent
  104. BR8 8NR
  105. +44 322 613509
  106.  
  107. !!! NOTE !!!
  108.  
  109. This application is Freeeware. I have included the source code for your info.
  110. You may use the code in other applications provided you obtain my approval.
  111. You may distribute it freely (with ALL files included), but not for any profit.
  112. (Charities excepted). This software is provided 'as is'. Using it is entirely at
  113. your own risk.
  114.  
  115.